<template><div><h2 id="类自动加载-autoloading" tabindex="-1"><a class="header-anchor" href="#类自动加载-autoloading"><span>类自动加载（Autoloading）</span></a></h2>
<p>Yii 依靠 <a href="https://www.php.net/manual/zh/language.oop5.autoload.php" target="_blank" rel="noopener noreferrer">类自动加载机制</a>来定位和包含所需的类文件。它提供一个高性能且完美支持 <a href="https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-4-autoloader.md" target="_blank" rel="noopener noreferrer">PSR-4 标准</a> 的自动加载器。该自动加载器会在引入框架文件 <code v-pre>Yii.php</code> 时安装好。</p>
<blockquote>
<p>Note: 为了简化叙述，本篇文档中我们只会提及类的自动加载。不过，要记得文中的描述同样也适用于 Interface 和 Trait 的自动加载哦。</p>
</blockquote>
<h2 id="使用-yii-自动加载器" tabindex="-1"><a class="header-anchor" href="#使用-yii-自动加载器"><span>使用 Yii 自动加载器</span></a></h2>
<p>要使用 Yii 的类自动加载器，你需要在创建和命名类的时候遵循两个简单的规则：</p>
<ul>
<li>每个类都必须置于命名空间之下 (比如 <code v-pre>foo\bar\MyClass</code>)。</li>
<li>每个类都必须保存为单独文件，且其完整路径能用以下算法取得：</li>
</ul>
<div class="language-php line-numbers-mode" data-highlighter="prismjs" data-ext="php" data-title="php"><pre v-pre class="language-php"><code><span class="line"><span class="token comment">// $className 是一个开头包含反斜杠的完整类名（译注：请自行谷歌：fully qualified class name）</span></span>
<span class="line"><span class="token variable">$classFile</span> <span class="token operator">=</span> <span class="token class-name static-context">Yii</span><span class="token operator">::</span><span class="token function">getAlias</span><span class="token punctuation">(</span><span class="token string single-quoted-string">'@'</span> <span class="token operator">.</span> <span class="token function">str_replace</span><span class="token punctuation">(</span><span class="token string single-quoted-string">'\\'</span><span class="token punctuation">,</span> <span class="token string single-quoted-string">'/'</span><span class="token punctuation">,</span> <span class="token variable">$className</span><span class="token punctuation">)</span> <span class="token operator">.</span> <span class="token string single-quoted-string">'.php'</span><span class="token punctuation">)</span><span class="token punctuation">;</span></span>
<span class="line"></span></code></pre>
<div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0"><div class="line-number"></div><div class="line-number"></div></div></div><p>举例来说，若某个类名为 <code v-pre>foo\bar\MyClass</code>，对应类的文件路径 <a href="https://github.com/yiisoft/yii2/blob/master/docs/guide-zh-CN/concept-aliases.md" target="_blank" rel="noopener noreferrer">别名</a> 会是 <code v-pre>@foo/bar/MyClass.php</code>。为了让该别名能被正确解析为文件路径，<code v-pre>@foo</code> 或 <code v-pre>@foo/bar</code> 中的一个必须是 <a href="https://github.com/yiisoft/yii2/blob/master/docs/guide-zh-CN/concept-aliases.md#defining-aliases" target="_blank" rel="noopener noreferrer">根别名</a>。</p>
<p>当我们使用 <a href="https://github.com/yiisoft/yii2/blob/master/docs/guide-zh-CN/start-installation.md" target="_blank" rel="noopener noreferrer">基本应用模版</a> 时，可以把你的类放置在顶级命名空间 <code v-pre>app</code> 下，这样它们就可以被 Yii 自动加载，而无需定义一个新的别名。这是因为 <code v-pre>@app</code> 本身是一个 <a href="https://github.com/yiisoft/yii2/blob/master/docs/guide-zh-CN/concept-aliases.md#predefined-aliases" target="_blank" rel="noopener noreferrer">预定义别名</a>，且类似于 <code v-pre>app\components\MyClass</code> 这样的类名，基于我们刚才所提到的算法，可以正确解析出 <code v-pre>AppBasePath/components/MyClass.php</code> 路径。</p>
<p>在 <a href="https://github.com/yiisoft/yii2/blob/master/docs/guide-zh-CN/tutorial-advanced-app.md" target="_blank" rel="noopener noreferrer">高级应用模版</a> 里，每一逻辑层级会使用他自己的根别名。比如，前端层会使用 <code v-pre>@frontend</code> 而后端层会使用 <code v-pre>@backend</code>。因此，你可以把前端的类放在 <code v-pre>frontend</code> 命名空间，而后端的类放在 <code v-pre>backend</code>。这样这些类就可以被 Yii 自动加载了。</p>
<p>要将自定义命名空间添加到自动加载器，您需要使用 [[Yii::setAlias()]] 为命名空间的根目录定义别名。例如，要加载位于 <code v-pre>path/to/foo</code> 目录中 <code v-pre>foo</code> 命名空间中的类，您将调用 <code v-pre>Yii::setAlias('@foo', 'path/to/foo')</code>。</p>
<h2 id="类映射表" tabindex="-1"><a class="header-anchor" href="#类映射表"><span>类映射表</span></a></h2>
<p>Yii 类自动加载器支持 <strong>类映射表</strong> 功能，该功能会建立一个从类的名字到类文件路径的映射。 当自动加载器加载一个文件时，他首先检查映射表里有没有该类。如果有，对应的文件路径就直接加载了，省掉了进一步的检查。这让类的自动加载变得超级快。事实上所有的 Yii 核心类都是这样加载的。</p>
<p>你可以用 <code v-pre>Yii::$classMap</code> 方法向映射表中添加类，</p>
<div class="language-php line-numbers-mode" data-highlighter="prismjs" data-ext="php" data-title="php"><pre v-pre class="language-php"><code><span class="line"><span class="token class-name static-context">Yii</span><span class="token operator">::</span><span class="token variable">$classMap</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'foo\bar\MyClass'</span><span class="token punctuation">]</span> <span class="token operator">=</span> <span class="token string single-quoted-string">'path/to/MyClass.php'</span><span class="token punctuation">;</span></span>
<span class="line"></span></code></pre>
<div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0"><div class="line-number"></div></div></div><p><a href="https://github.com/yiisoft/yii2/blob/master/docs/guide-zh-CN/concept-aliases.md" target="_blank" rel="noopener noreferrer">别名</a> 可以被用于指定类文件的路径。你应该在 <a href="https://github.com/yiisoft/yii2/blob/master/docs/guide-zh-CN/runtime-bootstrapping.md" target="_blank" rel="noopener noreferrer">引导启动</a> 的过程中设置类映射表，这样映射表就可以在你使用具体类之前就准备好。</p>
<h2 id="用其他自动加载器" tabindex="-1"><a class="header-anchor" href="#用其他自动加载器"><span>用其他自动加载器</span></a></h2>
<p>因为 Yii 完全支持 Composer 管理依赖包，所以推荐你也同时安装 Composer 的自动加载器，如果你用了一些自带自动加载器的第三方类库，你应该也安装下它们。</p>
<p>当你同时使用其他自动加载器和 Yii 自动加载器时，应该在其他自动加载器安装成功 <strong>之后</strong>，再包含 <code v-pre>Yii.php</code> 文件。这将使 Yii 成为第一个响应任何类自动加载请求的自动加载器。举例来说，以下代码提取自 <a href="https://github.com/yiisoft/yii2/blob/master/docs/guide-zh-CN/start-installation.md" target="_blank" rel="noopener noreferrer">基本应用模版</a> 的 <a href="https://github.com/yiisoft/yii2/blob/master/docs/guide-zh-CN/structure-entry-scripts.md" target="_blank" rel="noopener noreferrer">入口脚本</a> 。第一行安装了 Composer 的自动加载器，第二行才是 Yii 的自动加载器：</p>
<div class="language-text-html-php line-numbers-mode" data-highlighter="prismjs" data-ext="text-html-php" data-title="text-html-php"><pre v-pre class="language-text-html-php"><code><span class="line">require __DIR__ . '/../vendor/autoload.php';</span>
<span class="line">require __DIR__ . '/../vendor/yiisoft/yii2/Yii.php';</span>
<span class="line"></span></code></pre>
<div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0"><div class="line-number"></div><div class="line-number"></div></div></div><p>你也可以只使用 Composer 的自动加载，而不用 Yii 的自动加载。不过这样做的话，类的加载效率会下降，且你必须遵循 Composer 所设定的规则，从而让你的类满足可以被自动加载的要求。</p>
<blockquote>
<p>Info: 若你不想要使用 Yii 的自动加载器，你必须创建一个你自己版本的 <code v-pre>Yii.php</code> 文件，并把它包含进你的 <a href="https://github.com/yiisoft/yii2/blob/master/docs/guide-zh-CN/structure-entry-scripts.md" target="_blank" rel="noopener noreferrer">入口脚本</a> 里。</p>
</blockquote>
<h2 id="自动加载扩展类" tabindex="-1"><a class="header-anchor" href="#自动加载扩展类"><span>自动加载扩展类</span></a></h2>
<p>Yii 自动加载器支持自动加载 <a href="https://github.com/yiisoft/yii2/blob/master/docs/guide-zh-CN/structure-extensions.md" target="_blank" rel="noopener noreferrer">扩展</a> 的类。唯一的要求是它需要在 <code v-pre>composer.json</code> 文件里正确地定义 <code v-pre>autoload</code> 部分。请参考 <a href="https://getcomposer.org/doc/04-schema.md#autoload" target="_blank" rel="noopener noreferrer">Composer 文档</a>，来了解如何正确描述 <code v-pre>autoload</code> 的更多细节。</p>
<p>在你不使用 Yii 的自动加载器时，Composer 的自动加载器仍然可以帮你自动加载扩展内的类。</p>
<blockquote>
<p>💖喜欢本文档的，欢迎点赞、收藏、留言或转发，谢谢支持！<br>
作者邮箱：zhuzixian520@126.com，github地址：<a href="https://github.com/zhuzixian520" target="_blank" rel="noopener noreferrer">github.com/zhuzixian520</a></p>
</blockquote>
</div></template>


